home *** CD-ROM | disk | FTP | other *** search
/ The CICA Windows Explosion! / The CICA Windows Explosion! - Disc 2.iso / demo / medowl.zip / README.OWL < prev   
Text File  |  1994-08-18  |  6KB  |  158 lines
  1.                   OWL Classes for the Magma Editor DLL
  2.                   ------------------------------------
  3.  
  4. The OWL TEdit class
  5. -------------------
  6.  
  7. The TMagmaEdit family of classes are replacements for the TEdit family of
  8. classes which comes with OWL. The OWL TEdit class is only capable of edit-
  9. ing 32K of text. In fact, the edit.cpp source code always sets the maximum
  10. number of characters in an edit control to 30,000. The new TMagmaEdit clas-
  11. ses will let you edit an unlimited amount of text. In addition, you can use
  12. all of the new capabilities of the Magma Editor DLL. 
  13.  
  14. To use these new classes in your OWL application, you generally need to do
  15. only two "search-and-replace" operations. They are : 
  16.  
  17.   - Use the new include files. Use MEDT.H, MEDTFILE.H, MEDTSEAR.H and
  18.     MEDTVIEW.H in place of the existing EDIT.H, EDITFILE.H, EDITSEAR.H,
  19.     and EDITVIEW.H files.
  20.  
  21.   - Substitute the word 'TMagmaEdit' for 'TEdit' in your source. This
  22.     should take care of the four new classes, TMagmaEdit, TMagmaEditFile,
  23.     TMagmaEditSearch, and TMagmaEditView.
  24.  
  25. When you link your application, make sure to use the MEDITOWL.LIB
  26. library. Also, make sure that MAGMAED.DLL is in a directory which
  27. Windows ordinarily searches in order to locate DLLs.
  28.  
  29.  
  30.  
  31. Files Included :
  32.  
  33. MAGMAED.H      Main include file for the editor DLL. Copy this to the
  34.                \BC4\INCLUDE direcory
  35.  
  36. MEDITOWL.LIB   Library for the TMagmaEdit family of classes. Copy this
  37.                to the \BC4\LIB directory
  38.  
  39. \MDIFILE\*.*   Source code and makefile for the OWL MDIFILE sample.
  40.                Copy this to the \BC4\EXAMPLES\OWL\OWLAPPS\MDIFILE
  41.                directory. The IDE file is set up for the demo.
  42.  
  43. \SOURCE\*.*    Source code and make files for the OWL TMagmaEdit
  44.                family of classes. Copy the H files to the \BC4\INCLUDE\OWL
  45.                directory. You can copy the CPP and makefile to a new
  46.                \BC4\SOURCE\MEDT directory. You can use the MEDITOWL.IDE
  47.                project file to recreate the MEDITOWL.LIB library.
  48.  
  49. MAGMAED.DLL    Make sure to copy this into a directory which Windows
  50.                will search in order to load a DLL.
  51.  
  52.  
  53.  
  54. About the Magma Edit DLL
  55. ------------------------
  56.  
  57. The Magma Editor DLL/VBX is an edit control which provides a powerful al-
  58. ternative to the standard Microsoft Windows edit control. The Magma Editor
  59. (ME for short) is a line oriented text editing kernel which can be con-
  60. trolled by an application through a series of messages or through a
  61. high-level C-like macro language. You can think of the ME DLL/VBX as being
  62. a "BRIEF in a box". 
  63.  
  64. The editor kernel provides the following features and enhancements over the
  65. standard Windows editor control : 
  66.  
  67. - The size of the text is limited by the amount of memory Windows
  68.   can globally allocate. On the other hand, the standard Windows
  69.   edit control is limited to 64K of text.
  70.  
  71. - Extensive message-based API.
  72.  
  73. - Regular expression search and substitution
  74.  
  75. - Various block operations. Line marking, column marking, block
  76.   marking, and discontiguous line marking.
  77.  
  78. - Keyboard macros
  79.  
  80. - Messages to read and write to files.
  81.  
  82. - More varieties of cursor movement. Ability to jump to a specific line,
  83.   and to set bookmarks in the text.
  84.  
  85. - The ability to be in overstrike as well as in insert mode.
  86.  
  87.  
  88. The editing DLL is an editing kernel with no real associated user interface
  89. built in (no menus, few dialogs). It is based on the theory of the
  90. client/server model, where the editor is a "server" of editing functions.
  91. You can attach different user-interface related clients around the editor.
  92. It can be a control within a dialog box, it can function as a child window,
  93. or it can be a full-featured programmer's text editor.
  94.  
  95. The source code for the editor kernel is available at a reasonable price,
  96. so that you can modify and customize it for your own purposes.
  97.  
  98. It is our plan to release different user-interface shells (clients) around
  99. the editor DLL. The first shell we have written, the one which you see in
  100. MEWIN.EXE, was written in C using the standard Windows API calls. We have
  101. also released user-interface shells and classes for the Microsoft Foundation
  102. Classes (MFC), Borland's Object Windows Library (OWL), Inmark's zApp, and 
  103. Microsoft's Visual Basic. The source code for all of the user interface 
  104. shells will be available from Magma Systems so that you can write custom
  105. text editors for your applications.
  106.  
  107. The ME Text Editor for DOS had a full C-like macro language (much like
  108. Brief's) which could be utilized to add features to the editor and to
  109. control the editor's behavior. Magma plans on releasing a generic scripting
  110. DLL which can be used to not only control a Magma edit control, but to make 
  111. the editor into a repository for various different kinds of objects. For
  112. example, we plan on adding communications and report-writing modules to the 
  113. scripting engine so you can perform tasks like logging on to another
  114. computer, downloading data and images, and formatting it a certain way.
  115.  
  116.  
  117. Other Frameworks Supported
  118. --------------------------
  119.  
  120. We have replacement classes for the Microsoft Foundation Classes (MFC),
  121. Borland OWL 2.0, and Inmark's zApp. In general, the new classes based
  122. on the Magma Editor DLL are superior to the existing classes which
  123. come with the frameworks. The new classes allow editing large amounts
  124. of text, and add additional editing capabilities.
  125.  
  126.  
  127. How to contact us
  128. -----------------
  129.  
  130. The Magma Editor DLL/VBX is a commercial product. For information
  131. about the editor and the replacement classes, you may contact us at :
  132.  
  133.  
  134. Magma Systems
  135. 15 Bodwell Terrace
  136. Millburn, New Jersey  07041
  137. USA
  138.  
  139. (201) 912-0192  (voice)
  140. (201) 912-0103  (fax)
  141. (201) 912-0668  (BBS, 9600-1200 N-8-1)
  142.  
  143. Compuserve : 75300,2062
  144.              To get to our conference, GO MAGMA
  145.  
  146. Bix        : 'magma'
  147.              To get to our conference, 'join magma'
  148.  
  149. Internet   : 75300.2062@compuserve.com
  150.              magma@bix.com
  151.  
  152.  
  153. Magma Systems is also the maker of the well-known MEWEL User Interface
  154. Library. MEWEL is a user interface library which implements the Microsoft
  155. Windows API (and MFC and OWL) on non-Windows platforms, including
  156. DOS text, DOS graphics, UNIX text, and (soon) Motif.
  157.  
  158.